home *** CD-ROM | disk | FTP | other *** search
/ Acorn RISC PD-CD 1 / Acorn RISC PD-CD 1.iso / games / _hextris / _help < prev    next >
Encoding:
Text File  |  1993-01-12  |  12.5 KB  |  364 lines
  1. Documentation file for !Hextris version 0.20
  2.  
  3.  
  4.  
  5. Hextris is public domain. It is dedicated to all those, who deliver true
  6. quality public domain software.
  7.  
  8. This file describes the desktop game Hextris for the Acorn RISCOS range of
  9. personal computers. The game is quite simply a variation of the grand
  10. classic 'Tetris' game of the 1980s, though much harder. It is not necessary
  11. to read this file in order to play the game, so if you don't care about
  12. learning all the esoteric features of the game, just stop reading by the end
  13. of this paragraph and get playing!
  14.  
  15. If you reached this paragraph anyway, you will probably want to know a
  16. little more about the game of Hextris, so below is the table of contents of
  17. this file, each line is the name of a section describing some feature of
  18. Hextris.
  19.  
  20.  
  21.  
  22. Contents
  23. ______________________________________________________________________
  24.  
  25. Features
  26. Gameplay
  27. The Hextris Menu
  28. Scoring
  29. Extras
  30. Technical
  31. Disclaimer and Addresses
  32.  
  33.  
  34.  
  35. Features
  36. ______________________________________________________________________
  37.  
  38. Hextris is a desktop game, handwritten in assembler for smallness and fast
  39. execution. Below is listed the main features of Hextris.
  40.  
  41. Fully multitasking game in RISCOS desktop.
  42. Handwritten in ARM assembler, taking very little processor time.
  43. Compact program (approximately 16KB).
  44. User customisable. Settings can be saved.
  45. Control by keyboard or mouse.
  46. Adaptive to mode changes.
  47. Optimised redrawing.
  48. Permanent highscore table.
  49.  
  50.  
  51. Gameplay
  52. ______________________________________________________________________
  53.  
  54. Open the Hextris game window by clicking on its icon on the iconbar. The
  55. game is started by clicking the mouse select button within the game window.
  56.  
  57. Hextris can be controlled by either keyboard or mouse. The mode of control
  58. is selected by clicking the corresponding item within the menu
  59. 'Hextris.Options.Control'.
  60.  
  61.  
  62. Keyboard control
  63. ----------------
  64. The control keys can be altered in the submenu of
  65. 'Hextris.Option.Control.Keys'. The default keys are as follows:
  66.  
  67. Z - left
  68. X - right
  69. ' - rotate counter clockwise
  70. / - rotate clockwise
  71. <space> - drop
  72. H - toggle help
  73. P - pause (click in game window to resume game)
  74.  
  75. The game can also be paused by clicking the mouse select button within the
  76. game window. Note that Hextris will be paused if another application claims
  77. the input focus of the Wimp.
  78.  
  79.  
  80. Mouse Control
  81. -------------
  82. When Hextris is controlled by mouse, the brick is moved horizontally by the
  83. movement of the mouse. The left mouse button rotate the brick
  84. counterclockwise, while the right mousebutton rotates the brick clockwise.
  85. The middle button drops the brick.
  86.  
  87. Pausing the game under mouse control is obtained by either closing the game
  88. window or clicking the mouse adjust button in the Score/Help window. The
  89. game is started/resumed by clicking the mouse select button within the game
  90. window.
  91.  
  92. If Hextris is played with mouse, it does not claim the input focus of the
  93. Wimp. This means that you can use an editor, while your girlfriend play
  94. Hextris with the mouse.
  95.  
  96.  
  97. Hextris can be customised in its appearance in a variety of ways. The
  98. customisation is accessed in the submenu 'Hextris.Options'. The next section
  99. will describe most of the other features of Hextris.
  100.  
  101.  
  102.  
  103. The Hextris Menu
  104. ______________________________________________________________
  105.  
  106. Below is a description of each item in the Hextris menu, ordered top-down,
  107. as they appear on-screen.
  108.  
  109.  
  110. Hextris.Info
  111. The submenu of this item is the standard info box.
  112.  
  113. Hextris.Options
  114. The submenu of this item provides access to the various options of Hextris.
  115.  
  116. Hextris.Options.Control
  117. The submenu of this item is for selecting which control to use, either keys
  118. or mouse. Clicking this item toggles between the two modes of control.
  119.  
  120. Hextris.Options.Control.Keys
  121. Click this to select the keyboard for playing. The submenu of this item is
  122. used for selecting new control keys. See the section 'Gameplay' for details.
  123.  
  124. Hextris.Options.Control.Mouse
  125. Click this to select the mouse for playing. See the section 'Gameplay' for
  126. details of how to control Hextris with the mouse.
  127.  
  128. Hextris.Options.Sprites
  129. Clicking any of the four items in the submenu of this item, will change the
  130. appearance of Hextris, by loading a new set of sprites. If you have designed
  131. your own sprites, you can write the name of the spritefile into one of the
  132. icons (See the 'Technical' section for further details). The four menu items
  133. described below are the default names.      Hextris.Options.Sprites.medium
  134. Click this to select medium size, multicoloured appearance of the bricks.
  135.  
  136. Hextris.Options.Sprites.large
  137. Click this to select extra small size, multicoloured appearance of the
  138. bricks.
  139.  
  140. Hextris.Options.Sprites.small
  141. Click this to select small size, multicoloured appearance of the bricks.
  142.  
  143. Hextris.Options.Sprites.lhomo
  144. Click this to select the large size, homegeneous coloured appearance of the
  145. bricks. Note that this is a special variant and only applicable in 256
  146. colour modes. There are also small and medium size versions of this, called
  147. 'shomo' and 'mhomo' respectively.
  148.  
  149. Hextris.Options.Size
  150. The extent of the playarea can be controlled in the submenu of this item.
  151.  
  152. Hextris.Options.Colour
  153. Click within the submenu of this item to change the background colour of the
  154. playarea. Note that some bricks may be invisible, if the background colour
  155. is the same as the brick.
  156.  
  157. Hextris.Options.Adapt mode
  158. Click this item to toggle Hextris's automatic adaptation to mode changes.
  159. When this option is set, Hextris will try its best to adapt to a mode
  160. change, in effect ensuring a continuous fast update of the playarea. Note
  161. that disc access will occur on modechanges, when this option is enabled. See
  162. the section 'Technical' for further details.
  163.  
  164. Hextris.Options.Help
  165. Click this item to toggle the help feature. You can also toggle the help
  166. feature by clicking select within the Score/Help window.
  167.  
  168. Hextris.Options.Save
  169. Clicking this item will save all the current settings of the options on
  170. disc, such that Hextris will appear the same, next time it's loaded. All
  171. options, which can be set within the 'Hextris.Options', menu are saved.
  172.  
  173. Hextris.Show
  174. The submenu of this item controls opening of various information windows.
  175. Clicking directly on this item, opens the Help/Score window.
  176.  
  177. Hextris.Show.Help
  178. Click this item to open the Score/Help window. This window will display your
  179. current score and the number of lines you have cleared. If the help feature
  180. is enabled, the window will also show you the next brick to appear.
  181.  
  182. Hextris.Show.Statistics
  183. Click this item to open the statistics window. This window displays how many
  184. times each brick has occurred since you loaded Hextris.
  185.  
  186. Hextris.Show.Highscores
  187. Click this item to open the highscores window.
  188.  
  189. Hextris.Quit
  190. Click this to quit Hextris. Note that this item is only present on the
  191. iconbar menu.
  192.  
  193.  
  194.  
  195. Scoring
  196. _______________________________________________________________________
  197.  
  198. Scoring is awarded according to a rather complex scheme. All scoring is
  199. proportional to the level of play, ie. how many lines have been cleared. For
  200. each ten lines cleared, the level is advanced and the speed is increased.
  201.  
  202. The more lines you clear in one go, the more points you get per line
  203. cleared. That is, clearing two lines in one go will yield a higher scoring
  204. than clearing one line in two goes.
  205.  
  206. A small bonus is awarded for dropping the brick. The bonus is proportional
  207. to the number of lines the brick was dropped.
  208.  
  209. When the help feature is enabled all scoring will be reduced by 25%, due to
  210. the easier play.
  211.  
  212. If you have obtained a highscore, it will only be recorded, if the size of
  213. the game area is such that the number of lines is less than or equal to two
  214. times the number of columns.
  215.  
  216.  
  217.  
  218. Extras
  219. ________________________________________________________________________
  220.  
  221. Hextris has a number of shortcuts available, as described below.
  222.  
  223. Clicking the adjust mouse button on the iconbar will open both the game
  224. window and the Score/Help window. Note that the Score/Help window is also
  225. automatically opened, if the help feature is enabled.
  226.  
  227. Closing the game window with the adjust button will close all the windows of
  228. Hextris.
  229.  
  230. Clicking the select button in the Score/Help window will toggle the help
  231. feature.
  232.  
  233. If you have attained a highscore and Hextris is waiting for you to type it
  234. in, you are free to close the Hexscores window or start a new game by
  235. clicking in the game window. Hextris will then automatically insert the name
  236. of the last highscorer into the list of highscores.
  237.  
  238.  
  239.  
  240. Technical
  241. _____________________________________________________________________
  242.  
  243. This section describes the more esoteric features of Hextris. Reading this
  244. section will, among other things, enable you to customise the appearance of
  245. Hextris, by defining your own sprites!
  246.  
  247. Hextris includes a collection of spritefiles within the directory
  248. '!Hextris.Sprites'. Each brick consists of four sprites, where each sprite
  249. has the shape of a hexagon. A spritefile must contain at least three
  250. sprites. Spritefiles are named according to the mode the sprites within the
  251. file are defined in.
  252.  
  253. A spritefile is named 'BXY_abcdef'. We call 'BXY' the modeprefix. The
  254. elements of the filename are as described below:
  255.  
  256. 'B' is one of the digits '0', '1', '2' or '3'. The digit represents the base
  257. two logarithm of the number of bits per pixel (BPP) of the mode the sprites
  258. are defined in. That is, for modes with 16 colours, B equals '2', while for
  259. 256 colour modes, B equals '3' etc.
  260.  
  261. 'X' is a digit '0', '1', '2' etc. The digit represents the XEigFactor for
  262. the mode the sprites are defined in. The XEigFactor is the ratio between the
  263. external horizontal resolution and the internal horizontal resolution. F.ex
  264. in mode 12, the XEigFactor is one, while in mode 13, the XEigFactor is two.
  265.  
  266. 'Y' is similar to 'X', though 'Y' represents the YEigFactor.
  267.  
  268. 'abcdef' is a unique string, that is, a filename of at most six characters.
  269.  
  270.  
  271. When the 'Adapt mode' feature is disabled, Hextris will scale sprites and
  272. translate colours according to the current screen mode. Hextris will *not*
  273. try to adapt to the current mode. This can effect slow update of the game
  274. window. Hextris will only attempt loading of a new spritefile, if the
  275. current spritefile is incompatible with the current screen mode. This is the
  276. case when Hextris uses 256 colour sprites and the mode is changed to a 16
  277. colour mode.
  278.  
  279. Otherwise, when the 'Adapt mode' feature has been enabled from the menu
  280. 'Hextris.Options', Hextris will, upon a mode change or a change of sprites
  281. (from the menu 'Hextris.Options.Sprites'), try its best to adapt to the
  282. mode. Hextris will try each of the following actions, in the order they
  283. appear below.
  284.  
  285. 1 Load the spritefile, whose name is ticked in the submenu
  286. 'Hextris.Option.Sprites', prefixed by the modeprefix of the current Wimp
  287. screen mode.
  288.  
  289. 2 Load the spritefile with the same name as above, but with with an optimal
  290. mix of the default modeprefix and the modeprefix of the current screenmode.
  291.  
  292. 3 Load the spritefile with the same name as above, but using the default
  293. modeprefix.
  294.  
  295. 4 Load the default spritefile.
  296.  
  297. 5 Load the spritefile named '212_small'
  298.  
  299. When Hextris has succeeded in one of the above actions, the name of the file
  300. loaded, is stored in the default spritefile name.
  301.  
  302. See the file '!Hextris.Sprites.!ReadMe' for further details of how to design
  303. your own sprites.
  304.  
  305.  
  306.  
  307. Disclaimer and Addresses
  308. ______________________________________________________
  309.  
  310. First the utterly boring stuff...
  311.  
  312. Hextris is the exclusive copyright of Mads Meisner-Jensen. Hextris is Public
  313. Domain and may be freely copied, provided that all files are retained, and
  314. no changes made. No charge whatsoever for this software should be made under
  315. any circumstances, including charging for public domain discs!
  316.  
  317. Hextris is used at your own risk. I, The author Mads Meisner-Jensen, cannot
  318. accept any liability for any loss or damage arising from the use of Hextris
  319.  
  320. Any commercial use with the aim of profit of any part of this software and
  321. documentation, in part or whole is illegal without my written permission.
  322.  
  323. The files included in release 0.20 are, in alphabetic order:
  324.  
  325. !Boot
  326. !Help
  327. !Hiscores
  328. !Options
  329. !Run
  330. !RunImage
  331. !Sprites
  332. Sprites.!ReadMe
  333. Sprites.112_large
  334. Sprites.112_medium
  335. Sprites.112_small
  336. Sprites.211_large
  337. Sprites.211_medium
  338. Sprites.211_small
  339. Sprites.212_large
  340. Sprites.212_medium
  341. Sprites.212_small
  342. Sprites.312_large
  343. Sprites.312_lhomo
  344. Sprites.312_medium
  345. Sprites.312_mhomo
  346. Sprites.312_shomo
  347. Sprites.312_small
  348. Templates
  349.  
  350.  
  351.  
  352. Now some not so boring stuff...
  353.  
  354. If you have *any* comments, bug reports etc., please don't hesitate to
  355. contact me. You can contact me via electronic mail or human mail. Please -
  356. no phone calls. I read my e-mail almost every working day.
  357.  
  358. Mads Meisner-Jensen
  359. Valdemarsgade 6, st.tv.
  360. DK-9000 Aalborg
  361. Denmark
  362.  
  363. e-mail: mmj@vlsi-gw.vlsi.auc.dk
  364.